<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>

<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Microsoft HTML Help Workshop 4.0">
<title>HH_ALINK_LOOKUP command</title>
<style>@import url(coUA.css);</style>
<link disabled rel="stylesheet" href="htmlhelp.css">
</head>

<BODY>

<h1>HH_ALINK_LOOKUP command</h1>

<p>Looks up one or more Associative link (ALink) names in a compiled help (.chm) file.</p>

<p>The ALink names to search for, and the action to be taken if no matches are found, are specified in the <b>HH_AKLINK</b> structure.</p>

<br>
<table border=1 cellpadding=3 cellspacing=0 width=100%>
<TR VALIGN="top">
<TH><I>pszFile</I></TH>
<TH><I>dwData</I></TH>
</TR>

<TR VALIGN="top">
<TD>
Specifies the compiled help (.chm) file that contains ALink names.
</TD> 
<TD>
Points to an <a href="str_hh_aklink.htm">HH_AKLINK</a> structure.
</TD>
</TR>
</TABLE>
<BR>

<H2>Example</H2>
<pre><code>
HH_AKLINK link;
<br>link.cbStruct =     sizeof(HH_AKLINK) ;
<br>link.fReserved =    FALSE ;
<br>link.pszKeywords =  "open" ; 
<br>link.pszUrl =       NULL ; 
<br>link.pszMsgText =   NULL ; 
<br>link.pszMsgTitle =  NULL ; 
<br>link.pszWindow =    NULL ;
<br>link.fIndexOnFail = TRUE ;
<br>
<br>HtmlHelp(
<br>          GetDesktopWindow(),
<br>          "c:\\MyHelp.chm",
<br>          HH_ALINK_LOOKUP,
<br>          (DWORD) &link) ;
</code></pre>

<H2>Return value</H2>
<p>The handle (hwnd) of the help window.</p>

<H2>Comments</H2>
<ul>
<li>You must first call the <a href="cmd_hh_display_topic.htm">HH_DISPLAY_TOPIC</a> command before calling this command, to ensure that the help window is created.</li> 

<li>Help authors insert ALink names into target topic files using the HTML Help  <b>Compiler Information</b> feature.</li>

<li>An ALink name lookup can also be invoked using the HTML Help ActiveX control <b>ALink</b> command.</li>

<li>ALink name/KLink keyword lookups are case sensitive. Multiple keywords are delimited by a semicolon.</li>
</ul>


<H2>See also</H2>
<p><a href="cmd_hh_keyword_lookup.htm">HH_KEYWORD_LOOKUP</a></p>


<br>
<table border="0" cellpadding="0" cellspacing="4">
<tr>
<td valign="top"><a href="ov_about_htmlhelp_commands.htm"><img src="home.gif" width=20 height=18 alt="link to overview topic" border="0"></a>
</td>
<td><a href="ov_about_htmlhelp_commands.htm">About commands</A>
</td>
</tr>
<tr>
<td>&nbsp;
</td>
</tr>
</table>

<br>
<!--start keywords--->

<!--end keywords--->

</BODY>
</HTML>
